使用Hugo+GitHub Pages搭建个人博客
@ shiyindaddy · Thursday, Apr 23, 2020 · 2 分钟阅读 · 更新于 Apr 23, 2020

Hugo安装,官方文档:https://gohugo.io/getting-started/installing/

Hugo下载:https://github.com/gohugoio/hugo/releases

这里我选择二进制解压安装的方式在MacOS上安装Hugo。

https://github.com/gohugoio/hugo/releases/download/v0.69.0/hugo_0.69.0_macOS-64bit.tar.gz

1、解压tar包,复制hugo到/usr/local/bin/目录下

kai@KaideMacBook-Pro  ~  hugo version

Hugo Static Site Generator v0.69.0-4205844B darwin/amd64 BuildDate: 2020-04-10T09:10:40Z

此时我们就可以使用hugo了。

2、创建站点

kai@KaideMacBook-Pro  ~  mkdir /Users/kai/Hugo

kai@KaideMacBook-Pro  ~  hugo new site /Users/kai/Hugo

kai@KaideMacBook-Pro  ~/Hugo  hugo server

此时我们浏览器访问http://localhost:1313,会发现是一个完全空白的页面:

3、选择一个主题,放入themes文件夹

Hugo主题下载:https://themes.gohugo.io/

这里我选择的是Dream这个主题:https://themes.gohugo.io/hugo-theme-dream/

Demo:https://themes.gohugo.io/theme/hugo-theme-dream/

下载连接:https://codeload.github.com/g1eny0ung/hugo-theme-dream/zip/master

详细的配置请参考:https://g1eny0ung.site/hugo-theme-dream/

4、修改config.toml文件

5、创建文章

kai@KaideMacBook-Pro  ~  cd /Users/kai/Hugo

kai@KaideMacBook-Pro  ~/Hugo  hugo new about/desc.md

kai@KaideMacBook-Pro  ~/Hugo  hugo new posts/welcome.md

6、编辑md文件

desc.md

welcome.md

说明:用到的图片所在目录为themes/dream/static/img/,可以添加自己喜欢的照片到此目录。

7、执行hugo server本地浏览器访问http://localhost:1313查看效果

要在创建的站点目录下执行hugo server,我这里的路径是:/Users/kai/Hugo

8、github配置ssh keys,创建Repository

Github个人主页,Settings—> SSH and GPG keys —> 将本地生成的ssh公钥添加进来。目的是为了以后git传输方便,不用再输密码了。

ssh-keygen -t rsa

cat .ssh/id_rsa.pub

添加好ssh key之后,我们可以测试一下:

kai@KaideMacBook-Pro  ~  ssh -T git@github.com

Hi shiyindaddy! You’ve successfully authenticated, but GitHub does not provide shell access.

创建Repository的名字为:shiyindaddy.github.io(xxxxxx.github.io,其中xxxxxx为你的github的ID)

9、上传网站到Github刚才创建的shiyindaddy.github.io

kai@KaideMacBook-Pro  ~/Hugo  hugo -D

                   | ZH

——————-+—–

  Pages            | 19

  Paginator pages  |  0

  Non-page files   |  0

  Static files     | 43

  Processed images |  0

  Aliases          |  5

  Sitemaps         |  1

  Cleaned          |  0

Total in 45 ms

kai@KaideMacBook-Pro  ~/Hugo  ls -l

执行hugo -D之后会在该目录下生成public文件夹

kai@KaideMacBook-Pro  ~/Hugo  cd public

kai@KaideMacBook-Pro  ~/Hugo/public  git init

kai@KaideMacBook-Pro  ~/Hugo/public   master  git add .

kai@KaideMacBook-Pro  ~/Hugo/public   master ✚  git commit -m “myblog first commit”

kai@KaideMacBook-Pro  ~/Hugo/public   master  git remote add origin git@github.com:shiyindaddy/shiyindaddy.github.io.git

kai@KaideMacBook-Pro  ~/Hugo/public   master  git push origin master

Enumerating objects: 97, done.

Counting objects: 100% (97/97), done.

Delta compression using up to 8 threads

Compressing objects: 100% (84/84), done.

Writing objects: 100% (97/97), 1.57 MiB | 564.00 KiB/s, done.

Total 97 (delta 25), reused 0 (delta 0)

remote: Resolving deltas: 100% (25/25), done.

To github.com:shiyindaddy/shiyindaddy.github.io.git

  • [new branch]      master -> master

注:执行git push的时候可能会报错,这个时候执行git pull origin master之后再去执行git push

查看github的Repository

最后,浏览器访问http://shiyindaddy.github.io查看站点,如果部署的时候没有什么问题,如下:

© 2020 shiyindaddy's BLOG

关于我@shiyindaddy

你为什么那么努力?

因为我想买的东西很贵,我想去的地方很远,我想爱的人很优秀。

社交链接